Copyright ã1995 by NeXT Computer, Inc.  All Rights Reserved.

IXLanguageReader

Inherits From:	IXAttributeReader : Object

Declared In:	indexing/IXLanguageReader.h

Class Description

The IXLanguageReader class is used to locate and load language-specific IXAttributeReaders supplied by NeXT.  These readers are shipped in /NextLibrary/Readers, and are named for their target languages; for example, English.reader.  If an Indexing Kit object needs a reader, it uses this class to get a reader for the user's preferred language (as set in the Preferences application).  Your code can use this class to obtain a reader for a specific language.

IXLanguageReader is also used as an abstract superclass for language-specific readers.  Subclasses of IXLanguageReader that perform language-specific processing can be dynamically loaded from a reader file.  If you plan to create a loadable reader for a language not supported by NeXT, it should be a subclass of IXLanguageReader; contact NeXT Technical Support for further instructions on doing this.  If you plan to create a reader for something other than a natural language, create a subclass of IXAttributeReader.

Instance Variables

None declared in this class.

Method Types

Getting language information	+ installedLanguages
+ classForLanguage:

Getting objects associated with languages
+ readerForLanguage:
+ domainForLanguage:

Getting the target language	+ targetLanguage
- targetLanguage

Disabling dynamic loading	+ disableLoading

Class Methods

classForLanguage:

+ (Class)classForLanguage:(const char *)aLanguage

Returns the subclass of IXLanguageReader whose instances read text in aLanguage.  Only those readers found in /NextLibrary/Readers are considered.

disableLoading

+ disableLoading

Disables dynamic loading of IXLanguageReader subclasses for the application.

domainForLanguage:

+ domainForLanguage:(const char *)aLanguage

Returns an IXWeightingDomain specific to aLanguage, or nil if one can't be found.  Only those readers found in /NextLibrary/Readers are considered.  If aLanguage is ªDefaultº the user's default language (as chosen by the user with the Preferences application) is used.

installedLanguages

+ (char *)installedLanguages

Returns a string containing a newline-separated list of the languages for which readers are available.  The sender of this message is responsible for freeing the string.  Only the languages for readers found in /NextLibrary/Readers are returned.

readerForLanguage:

+ readerForLanguage:(const char *)aLanguage

Returns an IXLanguageReader which reads text in aLanguage.  If a reader specific to aLanguage can't be found, returns a reader for English, or a generic IXAttributeReader if the English reader is unavailable.  If aLanguage is ªDefaultº the user's default language (as chosen by the user with the Preferences application) is used.

targetLanguage

+ (NXAtom)targetLanguage

Returns the name of the language that the receiving IXLanguageReader subclass reads, or NULL if the receiving class is IXLanguageReader.

See also:  - targetLanguage

Instance Methods

targetLanguage

- (NXAtom)targetLanguage

Returns the name of the language that the IXLanguageReader reads.

See also:  + targetLanguage